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User's Manual Statement 


“This equipment generates and uses radio frequency energy and if not installed 
and used properly. that Is, in strict accordance with the manufacturer's, 
instructions, may cause interference to radio and television reception. It has. 
been type {ested and.found to comply with the limits for a Class B computing 
device in accordance with the specifications in Subpart J of Part 15 of FCC rules. 
which are designed to provide reasonable protection against such interference in 
4 residential installation. However. there 1s no guarantee that interference will 
not occur in a particulaninstallation. If this equipment does cause interference 
to radio or television reception, which can be determined by turning the 
equipment off and on, the user Is encouraged to try to correct the interference by 
fone or more of the following measures: 





~ reorient the receiving antenna 

— relocate the computer with respect to the receiver 

— move the computer away from the receiver 

— plug the computer into a different outlet so that computer and receiver 
are on different branch elreuits. 


“If necessary. the user should consult the dealer or an experienced 
radio/television technician for additional suggestions. The user may find the 
following booklet prepared by the Federal Communications Commission helpful: 
How to Identify and Resolve Radio-TV Interference Problems.’ This booklet is 
available from the U.S. Government Printing Office, Washington, D.C. 20402, 
‘Stock No. 004-000-00345-4 





First Edition— 1989 
First Printing—1983 


Copyright © 1983 by Commodore Business 
Machines, Inc 
All rights reserved. 


‘This manual is copyrighted and contains proprietary 
Information, No part of this publication may be 
reproduced. stored in a retrieval system, or 
transmitted in any form or by any means, electronic. 
mechanical, photocopying, recording. or otherwise, 
without the prior written permission of 
COMMODORE BUSINESS MACHINES, Ine. 





Printed in the United States of America 
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PREFACE 


This User's Guide introduces you to the C128-40, B128-80 and 
B256-80 personal computers. We've included Instructions for 
Set-up, Optional Equipment and Configurations, Keyboard Op- 
eration, Loading and Saving Programs, and information about 
Available Software. The Appendices contain the Extended BASIC. 
4.0 definitions and abbreviations, screen and character codes, 
memory and register maps, mathematical functions, pinouts. 
BASIC conversions, error messages, and a bibliography. 

Although the C128-40, B128-80 and B256-80 computers have 
a great deal in common, each has certain options and config- 
urations which distinguish it from the other two. All of these 
differences are clearly labeled. 

Once your system is set up and functioning properly, the 
chapters on Keyboard Operation and Loading and Saving Pro- 
grams sections and the various Appendices will help you use 
your new system, 


ORGANIZATION 





er’s Guide is organized into six chapters. 


Chapter 1 


INTRODUCTION presents the highlights of each computer. In 
addition, it explains advantages of joining a User's Club and 
subscribing to the Commodore magazines and the Commodore 
Information Network. 
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PREFACE 


Chapter 2 


SETUP contains the instructions you need to unpack, con- 
nect, and install each of the computers. The C128-40, B128-80 
and B256-80 are described in separate sections that help you get 
your machine up and running. The chapter also describes the 
wide variety of configurations and optional equipment (periph- 
crals) available for each of the computers. Finally, this chapter 
Presents a few “trouble shooting” and diagnostic procedures that 
can help you make adjustments to solve minor problems that 
may show up after you've installed a computer system. 


Chapter 3 


THE KEYBOARD AND ITS FEATURES takes you on a tour of 
the keyboard on the C128-40, B128-80 and the B256-80 com- 
puters. 


Chapter 4 


LOADING AND SAVING PROGRAMS tells you how to load and 
save both prepackaged software and your own custom designed 
programs. The chapter explains how this is done on both the 
Commodore DATASSETTE™ and the Commodore Disk Drives. 
For further details on the operating systems, we suggest you 
consult the manuals that come with your DATASSETTE™, 544 


inch Floppy Disk Drive(s), or the fast and powerful Commodore 
Hard Disk Drive(s) 


Chapter 5 


AVAILABLE SOFTWARE briefly describes some of the great 
business, scientific, and educational software newly available for 
the C128-40, B128-80, and B256-80 computers. For a complete 
listing of all available software for the entire line of Commodore 
Products, watch for the Commodore Resource Encyclopedia 
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coming soon to your local Commodore dealer and the computer 
departments of fine bookstores everywhere. 


Chapter 6 


APPENDICES are designed to be an expanded “quick refer- 
ence” section of the major features that programmers and many 
end users want most. For an in-depth presentation of the infor- 
mation, we suggest that you check out the highly detailed 
C128-40, B128-80 and B256-80 Programmer's Reference Guide. 





HOW TO USE THIS GUIDE 


Let’s take a look at the easy way to use this manual. 


1. As you look at the edge of each page you will notice that 
there is what we call an “inset tab.” The “inset tab" 
shows you exactly where the six chapters are located. 
Note that the beginning of each chapter is a solid blue 
page. Both of these features make it easy for you to get 
to the information you need quickly. 


2. To help you unpack, hook up, set up, and begin operat- 
ing your computer, Chapter 2 ("Setup") contains:many 
detailed illustrations that can make the installation of 
your equipment, with all its options, a quick and easy 
task. In addition, for all C128-40 owners, there is a 
step-by-step explanation at the end of Chapter 2 on 
making the proper color adjustments to your TV set or 
monitor. 


3. When we discuss a specific key, or want you to hit a 
particular key, we show you a visual cue 


(Example: a 
4, Since this manual covers three separate computers. any 
section that does not pertain to all three systems will be 


clearly labeled. 
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PREFACE 


5. Please note that this manual is not designed to 
teach the computer language BASIC (the primary 
language used in all Commodore computers). If you 
want to learn BASIC language programming techniqu- 
es, or any of the other languages available for use with 
your computer(s), we suggest that you consult the “Bib- 
lography” (Appendix R) for books that teach pro- 
gramming 
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CHAPTER ] 


INTRODUCTION 


© Features Overview 

© User's Clubs, Magazines, and 
the Commodore Information 
Network 





Your membership in the ever-growing family of high-power com- 
puter users begins today. now that you own one of the new gen- 
eration of personal computers from Commodore. 

Each of these computers gives you the ability to design the 
ideal computer system for your business, scientific, or educa- 
tional needs. Furthermore, as your needs change, your C128-40, 
B128-80, or B256-80 can be expanded to include the options you 
need to meet the demands of tomorrow's world. 

All new generation computers have certain standard built-in 
features which work the same way on each machine. However, 
the special differences between the C128-40, the B128-80 and 
the B256-80 give you a choice of styles, memory capacities, and 
advanced color graphics and sound capabilities. The “Features 
Overview” that follows is a brief summary of the similarities and 
differences of the 128-40, B128-80 and B256-80 computers. 
You will also find a few examples of the wide variety of config- 
urations you can create for your own computer. We're sure that 
you'll find hours of enjoyment ahead of you whether you're an 
experienced programmer or someone interested for now in using 
prepackaged software only. So take a few minutes to familiarize 
yourself with the many functions and applications you can per- 
form with your new computer. 

Finally we will look at the User's Clubs and why Commodore 
encourages their development. In addition, we explain the 
Commodore family of magazines, Commodore and Power/Play. 
and our paperless magazine, the Commodore Information Net 
work. 





FEATURES OVERVIEW 


COMMODORE C128-40 
Advanced Personal Computer 


Memory 


128K RAM expands to 256K internally, 704K exter- 
nally, totaling 960K 
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Features 
Extended BASIC 4.0 





° = 
=  IEEE-488 bus % 
a © RS-232C interface ) 

© Dual 8 bit user ports Ss 
- © 40 col. x 25 line screen display a 

© Works with user-supplied color monitor or TV with re 
a external modulator 

© 16 colors 

‘© Bit mapped graphics (320 x 200 dots (pixels) } 

© Two control ports for joysticks or paddles 

¢ 48K ROM (24K internal and 24K external via car- 


tridge) 

‘© 6509 microprocessor 

Direct audio output 

© 10 programmable function keys 

© Separate calculator keypad for quick computations 

Optional future processors include Z-80 or 8088 for 
CP/M® and/or CP/M®-86 

© Future languages will include U.C.S.D, Pascal 


Commodore B128-80 
Advanced Business Computer 


Memory 


© 128K RAM expandes to 256K internally, 704K ex- 
ternally, totaling 960K. 


Features 


* BASIC 4.0 
¢ IEEE-488 bus 
© RS-232C interface 

© Dual 8 bit user ports 

© 80 col. x 25 line screen display 

© Integral display 

© Easy read green phosphor screen 

© Swivel and tilt built-in monitor 

© Includes integral disk drive options 
© Detachable keyboard 
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6509 microprocessor 
Direct Audio Output 

10 programmable function keys 

(Version also to be available excluding integral disk 
and with external Video Display Unit option) 

® Separate calculator keypad for quick computations 
* Optional 2-80 and 8088 processors 

© Optional CP/M", CP/M'-86, and U.C.S.D. Pascal 
compatibility 


Commodore B256-80 
Advanced 16-bit Professional Computer 


Memory 


* 256K RAM, expandable externally to 960K (almost a 
megabyte online RAM memory!) 


Features 
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BASIC 4.0 

IEEE-488 bus 

RS-232C interface 

8 bit user port 

80 col. x 25 line screen display 

Integral display 

Easy read green phosphor screen 

Swivel and tilt sereen 

Includes integral disk drive options 

Detachable keyboard 

10 programmable function keys 

Built-in dual processors: standard 6509 processor, 
and 16-bit 8088 processor 

Direct Audio Output 

Separate calculator keypad for quick computations 
Optional processor includes Z-80 for CP/M® 
Optional 8087 math coprocessor 

Other future languages will include U.C.S.D. Pascal 
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USER'S CLUBS, MAGAZINES, 
AND THE COMMODORE 
INFORMATION NETWORK 


Commodore wants you to know that our support for users only 
begins with your purchase of a Commodore computer. That's 
why we've created two publications with Commodore informa: 
Gon from around the world, and a “two-way” computer informa- 
Uon network full of valuable input by and for Commodore com. 
puter users in the U.S. and Canada from coast to coast. 

In addition, we wholeheartedly encourage and support the 
growth of Commodore User's Clubs all over the globe. They are 
an excellent source of information for every Commodore compu 
ter user, from the beginner (o the most experienced. The maga: 
zines and network, which are described below. have the most 
up-to-date information on how to get involved with the User's 
Club in your area 

Furthermore, your local Commodore dealer is an excellent 
source of Commodore support and information. Your dealer can 
always provide literature and hardware support to fill your 
changing computing needs 

















Power/Play: The Home Computer Magazine 


When it comes to entertainment. learning at home, and practical 
home applications, Power/Play is the prime source of informa- 
tion for Commodore computer owners. It directs you to the User's 
Club nearest you and tells you about its activities. It describes 
software, games, programming techniques. telecommunications, 
and new products. Power/Play is your personal connection to 
other Commodore users, outside software and hardware devel- 
opers, and to Commodore itself. Published quarterly, it's only 
$10.00 for a whole year of home computing excitement 











Commodore: The Microcomputer Magazine 


Widely read by educators. businesspeople, and s 
well as home computerists, Commodore is our main vehicle for 


students, 
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sharing exclusive information on the more technical uses of 
Commodore systems. Regular departments cover the business. 
science, and education fields, programming tips. technical tips. 
and many other features of interest to anyone who uses, or is 
thinking about purchasing, Commodore equipment. Commo- 
dore is the ideal complement to Power/Play. It is published bi- 
monthly, and a subscription costs only $15.00 per year. 


Commodore Information Network 


The magazine of the future is here today. To supplement your 
subscriptions to Power/Play and Commodore magazines, the 
Commodore Information Network —our “paperless magazine" — 
ts available now. All you need is a Commodore computer. a tele- 
communications device called a modem, and your home or bust- 
ness telephone, 

Join our computer club, get help with a computing problem. 
“talk” to other Commodore friends, or get up-to-the-minute 
information on new products, software, and educational re- 
sources. Soon you will even be able to save yourself the trouble of 
typing in the program listings you find in Power/Play and 
Commodore by “down loading” directly from the Information 
Network. The best part of the network is that most of the an- 
swers to your questions are there before you even ask them 
How's that for service? 

To “call” our electronic magazine you only need a modem and a 
subscription to CompuServe™. one of the nation’s largest tele- 
communications networks, To make it easy for you to subscribe, 
Commodore will give you a free year’s subscription to Com- 
puServe™ inside every Viemodem package. 

Just dial your local number for the CompuServe" data bank 
nearest you and then connect your phone to the modem. When 
the CompuServe™ video text appears on your screen, type “G 
CBM" on your keyboard. When the Commodore Information 
Network's table of contents, or “menu,” appears on the sereen, 
its your turn to choose from one of our 16 departments. So 
make yourself comfortable, and enjoy the “paperless magazine 
that all the other magazines are writing about. 

For more information about the Commodore Information 
Network or about CompuServe™, visit your local Commodore 
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dealer or contact CompuServe™ customer service at 
800-848-8990 (in Ohio, 614-457-8600). 


COMMODORE INFORMATION NETWORK 


Main Menu Description Commodore Dealers. 
Direct Access Codes Educational Resources 
Special Commands. User Groups 

User Questions Descriptions 

Public Bulletin Board Questions and Answers 
Magazines and Newsletters Software Tips 





New Product Announcements Technical Tips 
Commodore New Directory Descriptions 
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C128-40 Unpacking/Packing 

© C128-40 Installation 
C128-40 Hookup and 
Configurations Available 
B128-80 and B256-80 
Unpacking/Packing 
B128-80 and B256-80 
Installation 


(Peripherals) 
Color Adjustment for the 
C128-40 

Trouble Shooting 
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Fig. 1~Commadore 128 (Fro 
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COMMODORE C128-40 


Unpacking/Packing 





‘The following step-by-step instructions show you how to con- 


nect your new computer to your monitor, television set, or sound 
system, and how to make sure everything is working properly. 

Before attaching anything to the computer, check the contents 
of the container. Besides this guide, you should find the follow- 
ing items: 


1. Computer 
2. AC Power cord 


If any items are missing or damaged. check back with your 


dealer immediately for repair or replacement. Be sure to save the 
packing materials for future storage or transport 
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Fig. 2-Commedore 128 (Reor view) 
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Installation Commodore C128-40 


Connect the computer to your TV as described below. See figure 
2 to locate each input and output on the back of your C128-40. 


1. 


Make sure that your computer and your video display 
monitor are turned OFF before starting your installa- 
tion. C128-40 computers have their power switch lo- 
cated in the baek of the machine on the left hand side. 
Attach an RF modulator (not included) at the connector 
labeled Audio/Video (5—pin DIN). Line up the pins with 
the corresponding holes and push the connector in. 
The cable will only go in one way. 

Attach one end of the TV cable to the RCA “phono”-type 
jack on the RF Modulator. Push in to connect the other 
end of the cable to the antenna switchbox. 

If you have a VHF antenna, disconnect it from your TV 
set 

Connect your VHF antenna cable to the screen terml- 
nals labeled “Antenna Input” on the switchbox. If your 
antenna cable is the round 75-ohm coaxial type, use a 
75-ohm to 300-ohm adapter (not supplied) to attach 
your antenna cable to the switchbox. 

Connect the twin lead output cable of the antenna 
switchbox to the VHF antenna terminals of your TV set. 
If your set is one of the newer types with a round 
75-ohm VHF connector, you will need a 300-ohm to 
75-ohm converter (not supplied) to connect the switch- 
box to the 75-ohm VFH antenna input on the set 

Set the TV's VHF tuner to the channel number indicated 
en the computer's Channel Selector Switch (channel 3 
or 4). If a strong local TV signal is present on one of 
these channels, select the other channel to avoid possi- 
ble interference. 

Plug the 3-prong AC power cord into a 120 volt, 60 Hz 
AC outlet. 











Your C128-40 should now be connected properly. No addi- 
tional connections are required to use the computer with your 
TV. The antenna switchbox will connect the computer to the TV 
when the slide switch is in the “Computer” position. When the 
switch is in the "TV" position your set will operate as a normal 
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television. If you want to connect your C128-40 to a monitor, see 
installation instructions for B128-80 Low Profile on page 27. 
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Fig. 3-Hook-up and Configurations aveilable 
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Fig. 4-8 Series High Profile (Front view) 
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Fig. 5-8 Series Low Profile (Front view) 
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Unpacking/Packing 


Most B series computers are shipped in two parts: 


1. Base and Video Display Sereen (one unit) 
(known as the "B’ Series High Profile model) or 
1a. Base alone (no Video Display Sereen) 
(known as the ‘B' Series Low Profile model) 
2. Keyboard with cable attached 





CAUTION: The bore ond display (Number 1 above) are connected to each 
other. The keyboard and base ere to be connected with the “telephone-type"” 
cable enclosed. Hf your computer hos on attached Video Display Sereen, i i 
very important that you do not try to remove ot disconnect the video display 
serwen from the computer bose. If you must remove the screen from the base for 
any reason, toke the entire unt bock to your dealer for the appropriate modifi 











In addition to the above items and this guide, you should find 
the following items: 


3. AC Power Cord (120 volts) 


4. Video Cable (8-pin DIN to RCA phono-type, Low Profile 
only) 


If any items are missing or damaged, check back with your 
dealer immediately for repair or replacement. 
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Fig. 6-8 Series (Reor view) 
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Installation (B Series) 
High Profile Model 


Make sure that your computer is turned off before start- 
ing installation. The B Series High Profile computers 
have their power switch located in the baek of the ma- 
chine on the left hand side. 

Plug the 25 PIN CABLE attached to the keyboard into 
the connector on the lower right hand side of the 
base/video display unit. Make sure that the Commo- 
dore Logo QB is facing up 

Plug the 3-prong AC power cord into the power cord jack 
located in the back of the base/video display unit, on 
the left hand side. The power cord fits only one way. 
Plug the 3-prong AC power cord into a standard wall 
outlet. 


Low Profile Model 


Connect the computer to your monitor as described below. See 
figure 6 to locate each input and output on the back of your B 
Series computer. 


1 


Make sure that your computer and your monitor are 
turned off before starting installation. The ‘B’ series Low 
Profile computers have their power switch located in the 
back of the machine on the left hand side. 

Attach the video cable to the computer at the connector 
labeled audio/video (5 pin DIN). Line up the pins with 
the corresponding holes and push the connector in. The 
cable will only go in one way. 

Attach the two RCA phono-type jacks to your video 
monitor inputs. See the monitor's manual for instruc- 
tions. 

Plug the computer AC power cord into a 120 volt, 60 Hz 
AC outlet. 


Your B Series Low Profile should now be connected properly. 
No additional connections are required to use the computer with 
your monitor. 
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NOTE: Seve the pecking materials thot your computer came in. Th 
your equipment bock in the bor for storage or tans 
described above. 
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Fig. 7-Heok-up and Configurations aveileble 


Expanding Your System (Peripherals) 
Printers 


A full range of printers is available, designed to match any 
need. Low cost, high speed dot matrix units are ideal for most 
applications. Where letter quality printing is required, the 
Commodore “daisy-wheel” printer produces the best results. 


Internal Disk Drive Units (B series only) 


Commodore offers you the option of purchasing a B128-80 or 
B256-80 computer with a pair of internal disk drives. These 
drives are built into the units just above the keyboard. The two 
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internal disk drives together are capable of storing ¥2 million 
bytes of information. This is in addition to the memory capacity 
of your external disk drives. Internal drives are convenient space 
savers. Unlike external drives, these integral devices rely on the 
main Central Processing Unit (CPU) for operation. 


External Disk Drive Units 


Single or dual floppy disk units, with storage capacity from 
170,000 characters to over 2 million characters. can be easily 
attached (o store programs and data. Hard disk units with 
capacities of 5 and 7.5 million characters can also be used with 
equal ease. 


Commodore's Datassette” Recorder 


This low cost tape unit lets you store programs and data on 
cassette tape and retrieve them later. The Datassette™ may also 
be used to load pre-written programs, 


RS-232C Port 


Your computer comes equipped with an industry-standard 
RS-232C serial interface. This interface provides you with access 
to a wide variety of peripherals, such as printers, terminals, 
modems, and data collection equipment. 

The RS-232C interface is implemented using the fully pro- 
grammable 6551 Asynchronous Communications Interface 
Adapter. With the 6551, you can program your RS-232C inter- 
face to match exactly the requirements of the device you're con- 
necting to It. 

The Extended BASIC 4.0 interpreter includes file level software 
support for the RS-232C interface channel, Open the RS-232C 
channel as you would any other file and access it with standard 
BASIC input/output statements. The RS-232C Port is device # 
2. See Appendix Q. 


CBM IEEE Port 


Your advanced computer supports the full range of Commo- 
dore CBM peripherals via the built-in IEEE-488 interface. Most 
disk units are “intelligent.” meaning they have their own mic- 
Toprocessor and memory. You can connect up to five disk drives 
at one time to your computer by “daisy chaining” them together 
through the IEEE-488 connector port. 
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IMPORTANT: The device numbers that are vsed withthe IEEE part must be within 
the range of 4 to 31 inclsive 


Commodore CP/M” 


Your B256-80 computer is equipped with an 8088 processor 
that allows you to access the existing library of CP/M-86 pro- 
grams. 

Commodore CP/M" is not a “computer dependent” operating 
system, Instead it uses some of the memory space normally 
available for programming to run its own operating system. Ac- 
cess to CP/M® makes even more prepackaged software available 
to you. in addition to the wide variety of Commodore software. 


Color Adjustment for the C128-40 


‘There is a simple way to get a pattern of colors on the TV so 
you can easily adjust the set. Even though you may not be famil- 
iar with the operation of the computer right now, just follow 
along, and you'll see how easy it is to use the C128-40. 

First, look on the left side of the keyboard and locate the 
key. This stands for ConTRol and is used, in con- 
junction with other keys, to instruct the computer to do a specific 
task 

To use a control function, hold down the key while 
depressing a second key. 

1. Hit the key. This will put the characters in 
reverse video. Normally, a character is colored against 
the background. In reverse video, this is reversed, like 
the negative of a photograph 

2. Hold down the (QS bar and a blue bar will move 
across the screen. : 

3. To try all 16 colors, hold down the [SEXHM key and 
in order press the calculator keypad keys through BJ} 
=e eo ee ee. OS. OE while using the 


bar to create color bars across the screen. 











Black Green 
White Blue 
HEM ea | Yellow 
Cyan Orange 
EM Purple EE oBrown 
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EBB Light rea 





Light green 


MM Gry Light blue 
Hm Gray 2 HM crys 
4. To return to the normal display mode: (a) press the 
and keys together, and (b) press 
the key and the calculator pad key Ei. 
5. Hit and you will be back to the 





usual character mode. 


6. Adjust the color and tint controls on your TV so that the 
display matches the colors you've selected 

7. At this point everything should be adjusted and working 
properly. If things still don't look quite right, consult 
the “Trouble Shooting” section which follows 


Trouble Shooting 


Thi 





section presents some of the minor problems you may 


encounter after you've connected the parts of your computer. If 


your difficulty 
= 128-40 


- PROBLEM CAUSE 





you come across a problem not listed here, your first step should 
be to check with your local Commodore dealer to help correct 


SOLUTION 





1. Power indicator Computer not on 
# light not on 


Power Cable not 
plugged in 


Power Supply not 
plugged in 

Bad fuse in the 
computer 


Make sure power 
switch is in the 
on position 


Check power 
socket for loose or 
disconnected 
power cable 


Check connection 
with wall outlet 
Take system to 
authorized dealer 
for replacement of 
fuse 
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PROBLEM CAUSE SOLUTION 
2. No picture on TV on wrong Cheek other 
video screen channel channel for 


Incorrect hookup 


Video cable not 
plugged in 
Computer set for 
wrong channel 


3. Random Cartridge not 
pattern on TV inserted properly 
sereen with 
cartridge in 
place 


4, Picture without — Poorly tuned TV 
color 


32. serur 


picture (VHF TV 
channel 3 or 4 ts 
used with RF 
modulator and 
standard TV. If 
you're using a 
monitor with a 
5-pin DIN cable. 
this solution is 
not appropriate) 


Computer 
connects to VHF 
antenna 
terminals on. 
standard TV or to 
video and audio 
inputs on video 
monitor 


Check TV output 
cable connection 
Set computer for 
same channel you 
have selected on 
your TV 


Turn power off 
and then reinsert 


the cartridge 


Return TV set 


( 


C 
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Impossible to 
write 

programs on 
the computer 


BE Key is 
down 


PROBLEM CAUSE SOLUTION 
5. Pleture with Bad color Adjust the color, 
poor color adjustment on hue, and 
your TV brightness 
controls on your 
AW; 

6. Picture with TV volume setting Lower the TV's 
excess audio is up too high audio volume 
background control 
noise 

7. Picture is OK TV volume setting Adjust the audio 
but you don't is down too low volume control 
have sound 

Auxiliary output Conneet the 

not properly sound jack to the 

connected auxiliary input on 
your amplifier 
and then turn the 
amp. selector 
switch to the 
“Aux.” position 

8. Picture is too Brightness level is Adjust the 

dark or too light set incorrectly brightness 
control level on 
your TV, monitor, 
or built-in video 
display screen 

9. Characters on Contrast ratio Adjust the 
the sereen are between characters contrast control 
hard to read and background is on your TV, 

too great or too monitor, or 
small built-in Video 
Display Screen 
10. It is The Sw Hit the 


MEE Key so 
that it returns to 
the standard “up” 
position. 
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B128-80 AND B256-80 


PROBLEM 


CAUSE 


SOLUTION 





1. Power indicator 
light not on 


2. No picture on 
video screen 


3. Random 
pattern on 
monitor with 
cartridge in 
place 


4. Pleture with 
excess audio 
background 
noise 


5. Picture 1s OK 
but you don't 
have sound 


34. SETUP 


Computer not on 


Power cable not 
plugged in 


Power supply not 
plugged in 

Bad fuse in 
Computer 


Incorrect hookup 


Video cable not 
plugged in 


Cartridge not 
inserted properly 


Monitor volume 
setting 1s up too 
high 


Monitor volume 
setting is down too 
low 


Make sure power 
switch fs in the 
On position 


Check’ power 
socket for loose or 
disconnected 
power cable 


Check connection 
with wall outlet 
Take system to 
authorized dealer 
for replacement of 
fuse 


Computer 

connects to video 
and audio inputs 
on video monitor. 


Check monitor 
output cable 
connection 


Turn power off 
and then reinsert 
the cartridge 


Lower the 
monitor's audio 
volume control 


Adjust the audio 
volume control 


C 


C 
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PROBLEM 


CAUSE 


SOLUTION 





9. 


The picture is 
too dark or too 
light 


Characters on 
the screen are 
hard to read 


A buzzing noise 
is coming from 
inside the 
computer (fan 
is for units with 
built-in disk 
drives only) 


It 1s impossible 
to write 
programs on 
the computer 


Auxiliary output 
not properly 
connected, 


Brightness level is 
set incorrectly 


Contrast ratio 
between characters 
and background is 
too great or too 
small 


Internal fan is 
loose or 
malfunctioning 





Connect the 
sound jack to the 
auxiliary input on 
your amplifier 
and then turn the 
amp. selector 
switch to the 
“Aux.” position 





Adjust the 
brightness 
control level on 
your monitor or 
built-in video 
display screen 


Adjust the 
contrast control 
on your monitor. 
or built-in Video 
Display Screen 


Return the unit 
to your local 
dealer for the 
repair 


Hit the 
key so 
that it returns to 
the standard “Up” 
position. 
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CHAPTER 3 


THE 
KEYBOARD 
AND ITS 
FEATURES 


¢ Format Keys 


calculator Pad Keys 





The keyboard is your most important means of communication 
with the computer. Now that you've got everything set up and 
adjusted, please take a few moments to familiarize yourself with 
the keyboard. 

The keyboard is similar to a standard typewriter keyboard. 
However. a number of new keys control specialized functions. 
What follows is a brief description of the various keys and how 
they function. 


Format Keys 
EG ad 


These keys signal the computer to look at the information you 
typed and to enter that information into memory. 


This key works the same way it does on a typewriter. Many 
are capable of displaying three letters or symbols. In the 
jormal” mode the standard alphabet of lowerease and uppercase 
characters are displayed. Use the key to get the upper- 
case characters. 

In the “graphics” mode, the uppercase and graphics characters 
are displayed, and the key gives you the graphics char 
acter shown gn the front of the key. 








OFF/RVS 





This key gives you access to the reversed image of all the avail- 
able characters on your computer. Pressing the 





key and pressing the key will put you back into un- 
reversed video. 


‘NORM 





This key gives you access to the graphics mode. Pressing the 

NORMIG! key will give you uppercase characters and the 
shifted graphics characters. Press the key a sec- 
ond time and your computer will return to the standard character 
set of uppercase and lowercase letters. 
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Editing Keys 


No one is perfect and Commodore takes that into account. Edit- 
ing keys let you correct typing mistakes and move information 
around on the screen, 


Cursor Control Keys: i Hi = aa 


‘The cursor control keys marked with down, up, left, and right 
arrows are located on the top right of the keyboard. The keys 
look like this: MM. for moving the cursor down, [i . for 
moving the cursor up, and [i . for moving the cursor left, 
and [BB . for moving the cursor right. The cursor keys have 
a special repeat feature that keeps the cursor moving until you 
release the key 


If you hit this key, the cursor will move a space to the left, 
erasing (DEleting) the previous character you typed. If you're in 
the middle of a line, the character to the left is deleted and the 
characters to the right automatically move together to close up 
the space 

Holding down the [SIGH key while pressing the 
key allows you to insert information on a line, For example, if 
you noticed a typing mistake in the beginning of a line — perhaps 
you left out part of a name — you could use the cursor left key 
to move back to the error and then hit a shifted [ixSDDIm to 
make a space. Then just type in the missing letter. 


CLR HOM 


This positions the cursor at the “home” position of the screen. 
which is the upper left-hand corner. Holding down the [EST 
key while pressing the key will clear the sereen and 
place the cursor in the “home” position 











Function Keys 
The ten function keys in the upper left position of the keyboard 
can be “programmed” to handle a variety of functions. They are 


numbered from 1 to 10 and each key can be defined in man 
ways to handle repetitive tasks 





oo oo 
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You will not find these function keys labeled separately on your 
computer. In order to use this second set of function keys, hold 
down the Key while pressing one of the ten function 
keys marked through [EEE . In each case the function 
accessed will be the one whose number is 10 more than on the 
keyboard 


Standing for CONTROL, this key allows you to set colors (on 
the Commodore 128 only), and perform other specialized func- 
tions. You hold the key down while depressing another 
designated key to set colors or get a control function. 


Normally. depressing this key will stop the execution of a BASIC 
program. It Is the computer to stop doing something. Hold- 
ing down th key while pressing the key 


lets you automatically load the first program from a casscite tape. 


The [KG key performs a specialized function. It is used most 
often when you are listing a program on the screen. Pressing 
the KQH key will stop a program from continuing to “scroll 
any key to restart the scrolling function. 














ESC 


This key is used in conjunction with any of the 26 alphabet 
keys MEW through [EZ (o perform a wide variety of special func 
tions. To perform any function listed below, hit the [EG key 
and then the appropriate letter. 


EW Automatic insert 
HA Cance! automatic insert 
HA COCéeelette line 
Nonflashing cursor—B series only 
ga 
Gg 


Flashing cursor—B series only 
Enable (turn on) bell 
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Disable (turn off) bell 
Inset line 
Move to the start of the line 
Move to the end of the line 
Enable scrolling 
Disable scrolling 
Normal screen—B series only 
Cancel insert, quote and reverse 
Erase to the start of the line 
Srase to the end of the line 
Reverse screen—B series only 
Solid cursor—B series only 
et the Lop of the page 
Underscore cursor—B series only 
Scroll up 
Scroll down 
Cancel escape sequence 
Normal character set—B series only 
Alternate character se(—B series only 

















Calculator Pad Keys 


For your calculating convenience, all of the 
functions have been made easily accessible via the calculator 
keypad on the right of the keyboard. 


This key is the standard Commodore abbreviation for the 
PRINT statement in BASIC. Therefore, by preceding a calculation 
with a HEM. the computer can act as a calculator. For example: 

723.458 
187.6 
‘The HI key, when pressed while is held down, also func- 
tions as the color control key for the color of light red on the 
C128-40 computer only.(Located at the bottom right section of 
the main keyboard, it will also work as the [gM key in the 
€d, normal mode or unshifted, graphics mode.) 


he number keys are arranged like a regular calculator. 
It doesn’t matter if you're in normal mode. graphics mode, 
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MEDIRM cc oF unshifted, Notice that we have included a double 
zero (MM for your calculating convenience. (In addition, these 
keys function as the first nine color control keys when pressed 
in conjunction with the KBIN@M key on the C128-40 computer 
only.) All numbers located at the top of the main keyboard sec- 
tion can be used in calculations when your computer is operat- 
ing in the unshifted, normal mode. 


This serves as a decimal point for your noninteger computa- 
tions. (The period, located at the bottom right section of the main 
keyboard, will also work as a decimal point in the unshifted, nor- 
mal mode.) 


The MH key operates as a symbol for the arithmetic operation 
of division. (I also functions, when pressed in conjunction with 
the key, as the color control symbol for the color of gray 


1 in the C128-40 computer only.) The J key located at the bot- 
tom right section of the main keyboard will also function as a 
division symbol in the unshifted, normal mode. 


The MEM key operates as a symbol for the arithmetic operation 
of subtraction. It also operates as the “unary minus” symbol. 
which is the minus sign preceding negative numbers. (In addi 
tion the [J functions, when pressed in conjunction with the 
key, as the color control symbol for the color of gray 
2 in the C128-40 computer only.) The [Ml key located at the top 
right section of the main keyboard will also function as the sym- 
bol for subtraction and unary minus in the unshifted, normal 
mode. 


This key is somewhat similar to the “Clear Entry” key found 
on most calculators. Use this key when you want to eliminate 
the last number entered. It will clear the last number on a compu- 
lation line, back to the last arithmetic operation. (The JRGEa 
key also functions, when pressed in conjunction with the 
(SEW Key, as the color control symbol for light green on the 
C128-40 computer only.) 
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This operates as a symbol for the arithmetic operation of multi. 
plication, (It also functions, when pressed in conjunction with 
the EHX key, as the color control symbol for the color of light 
blue in the C128-40 computer only.) You can also use 
the [El key located at the top right section of the main keyboard 
when operating in the shifted normal mode or the unshifted 
graphics mode. 


This operates as a symbol for the arithmetic operation of addi- 
tion. It also operates as the “unary plus” symbol to represent 
positive numbers. However, “unary plus” is automatically as 
sumed by the computer and is therefore not essential. (The 
key also functions, when pressed in conjunction with the 
key, as the color control symbol for the color of gray 
3 on the C128-40 computer only.) You can also use the IES key 
located center right in the main section of the keyboard when 
operating in shifted normal mode or unshifted graphics mode. 
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CHAPTER 


LOADING AND 
SAVING 
1d Cole) VN 


LOADing Prepackaged 
Programs From Diskette 
LOADing Prepackaged 
Programs From 
DATASSETTE™ 

LOADing and SAVEing Your 
Programs on Diskette 
LOADing and SAVEing Your 
Programs on DATASSETTE 





One of the most important features of your Commodore computer 
is the ability to save and load programs to and from cassette 
tape or disk. 

‘This capability allows you to save for use at a later time the 
programs you write or to purchase prepackaged programs for 
use with your C128-40 or B series computer. 

Make sure that either the disk drive or DATASSETTE™ unit 
is attached according to its operating instructions. 

For those interested in using prepackaged programs available 
on cassette or disk, here's what you have to do. 


Loading Prepackaged Programs from Diskette 


1. Start by carefully inserting the preprogrammed disk into 
drive zero (0). 





NOTE: The computer will ahways assume thot you're puting your disk into drive 
2er0 (0) and thot you're using dik drive uit number eight (8). These ore known 
(0 “default valves.” If you wont to use nother drive or unit number you mus 
Use the optional codes shown in Appendix A in square brackets (+1) 





2. Make sure that the label on the disk is facing up and 
is closest to you. 


3. Look for a little notch on the disk (it might be covered 
with a small strip of tape). If you're inserting the disk 
properly the notch will be on the left side. 


4. Once the disk is inside, close the protective gate as de- 
scribed in your disk drive manual, 


5. Now type: 
DLOAD“PROGRAM NAME” 


6. Nowhit the [ETI key. 


‘The disk will make noise and your screen will say: 


SEARCHING FOR 0: FILE NAME 
LOADING 
READY. 
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7. When the “ready” comes on and the cursor appears. type: 
RUN 
8. Hit the key and your prepackaged software 


is ready to use. 


Loading Prepackaged Programs from Datassette” 





1, Use your DATASSETTE™ recorder and the ordinary audio 
cassette tapes containing your prepackaged program. 


2. Make sure the tape is complet 
hing of the first side. 





rewound to the begin- 


3. Now type: 
Loa 


4. Hit the key, 
‘The computer will answer with: 





PRESS PLAY ON TAPE 


5. You respond by pressing PLAY on your DATASSETTE™ 
machine. 


CHAPTER 4 


AL this point the following message will appear: 


SEARCHING 
LOADING 


READY. 


° 


When the “ready” comes on and the cursor appears type: 


a RUN 


= 7. Hit the ke 


is ready to use. 





. and your prepackaged software 
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Loading and Saving Your Programs on Diskette 


Loading a program from disk is simple. 
1 





‘ype 
DLOAD PROGRAM NAME 


2.Nowhitthe ERIM key 


The disk will start whirring and display. 


SEARCHING FOR 0: PROGRAM NAME 
LOADING 


READY. 





IMPORTANT: When you load a new program into the computer's memory, any 
‘rsractions thot were inthe computer belore you typed “load” will be erased. Make 
sure you seve the progrom you're working on before loading a new one. Once 
© program hes been loaded, you con run i, lst i, or make chonges ond sove 
the rms version, 





Saving program on disk is easy 
1. Type 
DSAVE “PROGRAM NAME" 
2, Now hit the key. 


The disk will start to churn and the computer will respond 
with 


SAVING 0: PROGRAM NAME 
OK 
READY. 


Before using a brand new diskette for the first time, you must 
format it with the HEADER command. 


1. Place the new diskette you wish to format in drive 0. 
2. Type 

HEADER “DISKNAME”, DO 

where “diskname" is a name for the disk. 
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3. Now hit the key 
4. The computer will type: 
‘ARE YOU SURE? 
5. Respond by typing: 
y 
6. Hit 


The disk drive will make noise and the new diskette will be 
headered. (This process takes a couple minutes) 





NOTE: Using the HEADER command erases ony previously stored informetion on 
the disk. Be coutious when using ths command. 





Loading and Saving Your Programs on 
Datassette™ 


Loading a program from tape is simple. 
1, Rewind the tape back to the beginning of the cassette. 


2. Type: 


CHAPTER 4 


LOAD "PROGRAM NAME” 


If you don’t remember the program name. load the next 
program on the tape by typing, 





Load 


3. Now hit the 
with: 





key. The computer will respond 


PRESS PLAY ON TAPE 


4. Now depress the PLAY key on your DATASSET 
corder. 





LOADING AND SAVINGS PROGRAMS 49 


The following message will appear on your screen: 


SEARCHING FOR “PROGRAM NAME” 
LOADING. 


READY. 


Aller entering a program, you may want to save it on cassette 
tape. Here's all you do: 





1. Type: 
SAVE PROGRAM NAME 
‘The program name can be up to 16 characters. 
2. Nowhit the EDIE key, 
‘The computer will respond with 
PRESS PLAY AND RECORD ON TAPE 


3. Press both the RECORD and PLAY keys on the 
DATASSETTE™. 


After the program is saved on tape, the “ready” prompt will 


reappear, indicating that you can start working on another pro- 
gram or just turn the computer offand take a break. 
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Much of the wide variety of software available for the Commo- 
dore 64 will be made available for the C128-40. 

Also, much of the exciting and varied software available for the 
CBM 8000 series will be converted to the B series computers. 

For your programming convenience, assembler software will be 
available for both the C and B series computers. An assembler is 
virtually essential to your machine language level programming. 
Also, a BASIC compiler will be available for the machines, allow- 
ing compilation of your BASIC programs Into highly efficient 
machine language. 

The graphics capabilities of your C128-40 computer are placed 
right at your fingertips by using the popular LOGO computer 
language. LOGO allows graphics definitions and movement, text 
display, and multi-level graphic character display. The instruc- 
tions are easy to use and the Commodore keyboard is used for 
easy screen editing. 

Many of Commodore's Easy group of software will be made 
available for the C128-40 or the B series. 

EasyCalc provides one of the largest electronic worksheets 
available. It allows selective row reporting and printing and in- 
stant “what if” calculations. Integration of spreadsheets, from 
disk to memory, allows summation and consolidation of differ- 
ent sizes and type matrices. 

EasyFile is a database product that allows you to define the 
data you wish to keep track of and how it looks on the screen. It 
also gives you the ability to enter and retrieve your data with 
editing and selective criteria. 

EasyScript is a word processor which provides you with all of 
the options of much larger products and even more. Variable text 
width, right margin justification or alignment, complete cursor 
movement, function keys for frequently used options, and verti- 
cal and horizontal tabs allow easy text formatting. Range selec- 
tion for text movement options. search and replace, scrolling in 
all directions, and user defined characters make text editing 
simple. 

EasySchedule, soon to be available for the C128-40, allows 
input of data in easy logical steps. Day, week, month, and year at 
a glance lets you see the scheduled items by time slots. The 
“Zoom” option lets you zero in on smaller and smaller time slots. 
Certain key areas of the program can be tallored to your specific 
needs. 
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EasyPlot, soon to be available for the B series computers. pro- 
vides you with full page printing of all charts and graphs. Inte- 
grates with EasyCale for data. or allows you to input up to 80 
data points directly. [t will plot up to four data series at a time 
depending on the type of plot required. EasyPlot produces bar 
charts, scatter diagrams, pie charts. and line graphs 

EasySpell, also to be available for the B series, is an ingenious 
disk-based program compatible with the EasyScript word pro- 
cessor: This computerized spelling checker automatically cor- 
Teets your spelling errors and counts the words in your manu- 
script or contract 

Software for the B series will also include terminal software, 
Cale Result, and BPI Accounting. For the C128-40, Calc Result, 
and an entry level word processor, the Word Machine and Name 
Machine programs, will be available. 

The Programmer's Reference Guide for the C128-40 and B 
series of computers will provide you with much more detailed 
information on the technical aspects of your computer than can 
be adequately described in this short book. Look for it at your 
local dealer or book store. 
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APPENDIX A 


BASIC 4.0 
COMMAND, 
STATEMENT, AND 
FUNCTION LIST 


The BASIC commands, statements, and functions below are 
explained in more detail in the Programmer's Reference Guide 
for the C128-40, B128-80, and B256-80. This list is designed as 
a “quick reference” for someone already familiar with the BASIC 
programming language. For those who are just beginning to 
learn about BASIC, see Appendix R for a list of tutorial-type 
books on learning BASIC. 

The following conventions are used to describe the BASIC 
commands, statements. and functions in this appendix: 


© Keywords appear in uppercase letters. Keywords are 
the words that your computer knows, These words 
cannot be used as part of your filenames or other 
variable names unless they are surrounded by quo- 
tation marks (" "), We do not recommend the use of 
any keywords for variable names. You must enter 
these keywords exactly as they appear. 

Arguments appear in lowercase letters. Another 
word for argument is parameter. You select those 
arguments needed for your statement. Arguments 
include: variables, expressions, linenumbers, ete. 


© A vertical bar (|) separates arguments in cases 
where you can select any one of a list of arguments. 
© Square brackets {))_are used to show optional 


arguments. You select any, or none, of the argu- 
ments listed, depending on your needs. 
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© Angle brackets (<>) mean that you must choose 
one of the arguments. 

© An Ellipsis, a sequence of three dots...) 
means that an option or argument can be repeated 
more than onee, if necessary 





© Quotation marks ("| are used to enclose char- 
acter strings, filenames and other items. 





Variable means any valid BASIC vari 


© Expression means any valid BAS 
as A+B+2 or .5+X. 


BASIC COMMANDS 


BACKUP 
FORMATS AND COPIES 


BACKUP Ds TO Dd [ON Uz] 

All the diskette files on drive s are duplicated to drive d. Here 
“s” is the number of your source drive. “d” is the number of your 
destination drive, and “2” is the drive unit number if you have 


more than one disk drive unit. 


ble name. 








IC expression, such 





CATALOG 

CATALOG [D8] ON Uy] [, "search paitern® | 
Displays the names of the files on your diskette. 

COLLECT 

COLLECT [Ds] ON Uy] 





The avatlable space on drive s is collected. Note improperly 
closed files are deleted. Here "s” is the drive number and "y" is 
the drive unit number. 





cCONcAT 
CONCAT [Ds,] “sourcefile” TO [Dd,| “destfile” [,ON Uz] 





Concatenates (merges) two data files. Here “s” represents the 
drive number of the disk drive containing the “sourcefile”, “d” is 
the drive number of the “destfile”. and “z” is the drive unit 
number if more than one drive unit is present. 
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cont 
conT 

Continues or re-starts the execution of a program which was 
interrupted because you hit the STOP key or the program exe- 
cuted a STOP statement or an END statement. 
copy 


COPY [Ds,] “sourcefile” TO [Dd,] “destfile” [.ON Uz] 

The file in drive s is copied onto the file in drive d of unit z 
Here “s” is the drive number of the file named “source file." “d" is 
the drive number of the file named “destfile,” and “2” is the drive 
unit number. 

DELETE 
DELETEs [from linenumber|~[to linenumber] 


DELETE from memory a group of tines from the BASIC pro- 
gram currently in memory, When using DELETE be aware that: 
1. DELETE (erases-the-entive. program) or 60 / 
2. DELETE linenumber— (erases from linenumber to end) 
3. DELETE —linenumber+ (erases from start to linenumber) 
4, DELETE linenumber— 
linenumber (erases from linenumber 
to linenumber) 








DIRECTORY 


DIRECTORY [Dnumber] [."filename] [,ON Uyl [., "seare k potter’) 

Displays the names of the files on your diskette. Only those files 
that match the specified filename are displayed. Here “number” is 
the number of the disk drive that contains the diskette, 


DLOAD 
DLOAD “filename” [,Ddrive-number] [.Uunit] 


Loads (bring into memory) a BASIC program that is stored on 
a disk, Here “drive-number” is the drive number of the disk and 
“unit” is the drive unit number. 


DSAVE 
DSAVE “filename” [.Ddrive-number] [,Uunit] 

Stores a BASIC program on disk. Here “drive-number" is the 
drive number of the disk and “unit” is the drive unit number. 
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HEADER 


HEADER “diskname’, Dd [.Ivv] [,ON Uz] 

Formats a diskette, assigning it a disk name and Identification 
number. Here “d” is the disk drive number, “wv" can be any alpha- 
betic characters you want to use as identification numbers, and "2" 
is the drive unit number if you have more than one drive unit 


List 





LIST [[from linenumber] [—] [to linenumber]] 


Displays one or more lines of the BASIC program currently in 
memory. When using LIST be aware that 


1, LIST (lists the entire program) 

2. LIST linenumber— (lists all lines from that 
number to the end) 

3. LIST—linenumber (lists all lines up to that 
number) 


4. LIST linenumber— 
Iinenumber (lists all lines from linenumber 
to linenumber) 
LoaD 


LOAD Filename’ [.device|[ woods 5 
LOADs (bring into memory) a program that is stored on an ex- 
ternal device, such as a tepe-cassettesor disk, Here “device” is 
the device number of the storage device you are using. H-ne-de- 
vice number is_used, the computer wittassume that you-wantte 
use the DATASSETTE “. which is device number-t 
NEW 
NEW 

Erases the current BASIC program and data from memory so 
that a NEW program can be loaded or entered. 


RENAME 


RENAME [,Ddr] “oldname” TO “newname” [,ON Uz] 

Changes the name of a file on a diskette without altering the 
Jile. Here “dr” represents the number of the disk drive in which 
the files are located and “2” represents the drive unit number if 
you have more than one disk drive unit 
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RUN 
RUN [linenumber) 


Begins execuling the BASIC program currently in memory. 
When using RUN be aware that 


1. RUN (starts a program from the 
beginning) 

2. RUN linenumber (starts a program from that 
linenumber) 





NOTE: If the line number does NOT exi 





YoU will get am error messoge. 





SAVE 
SAVE [ “filename” | device] 


Stores BASIC programs and data on an external storage 
medium, such as a tape cassette or diskette. Here “device” is 
the device number of the storage device you are using. If no de- 
vice number is used, the computer will assume that you want to 
use the DATASSETTE™, which is device number 1 


SCRATCH 
SCRATCH “filename” [,Dd] [,ON Uz] 


Erases a single file from a diskette, Here * 
disk drive number where the file can be found. 
unit number of the disk drive if you are u: 
drive unit 


represents the 
represents the 
ng more than one 








VERIFY 
VERIFY [“filename”] [.device] 


Checks a program on tapeser disk against the program cur: 
rently in memory. Here “device” 1s the device number of the 
storage device you are using. If-no-deviee_number-is-used—the 
computerwill-assume-that-you-want Louse the DATASSEPTE™. 
which is deviee-number-+ When using VERIFY be aware that: 
+-VERIFY ———__{cheeks-the-next-program-on 
tape) 
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2. VERIFY “filename {searches -for-tieneme-on-tape 
-and_then-cheeks-against 
memory} 
IFY “filename” 8 (searches for filename on disk 
and then checks against 
memory) 





BASIC STATEMENTS 
APPEND 
[linenumber] APPEND If, “filename” [.Dd] [,ON Uz] 


Opens a sequential data file called “filename” and positions 
the file pointers beyond the current end of the file. Here “If* rep: 
resents the logical file number, “a” is the disk drive number and 
“z* ts the unit number of the disk drive if more than one unit is 
present 


BANK 
[inenumber] BANK expression 


Sets the indirection bank number for use with some BASIC 
commands such as PEEK, POKE, BLOAD, and BSAVE. Re- 
member that you have 16 BANKs to choose from. 


BLOAD 
(linenumber] BLOAD [fileopt 





[ON] Bbanknumber] [,Plowoffset] 


Loads a binary file‘into any memory location. Here “fileopts” 
is your file options, “banknumber lets you select one of the 16 
banks, and “lowoffSet” is location in the bank to start loading, 


BSAVE 


BSAVE fileopts [MLON]Bbanknumber] [,Plowoffset] [TO 
Phighoffset] [ > 0N U2. 


te disk 
Saves a binary fildfrom any specified memory location. Here 
fileopts” is your file options, and “banknumber” lets you select 
one of the 16 banks. The “lowoffset” is the location in the bank 
beginning the information to be SAVEd. The “highoffset” is the 
location in the bank ending the information to be SAVEd. 





i=} 
2 
a 
a 
< 





LOS = 


{linenumber] CLOSE filenumber _ 
3 betes fGtenumber | 
CLOSEs a file which was opened with a previous OPEN 
statement, 


Abc 056 * by rhc} closes fit epta Siles. 











NOTE: The filonumber must be the same number used in the OPEN si 
See your Dotassette™, Disk Drive, oF Pri 








rmonvel(s) for more details. 





CLR 
(nenumber] CLR 
CLeaRs all BASIC variables in memory, but leave the pro- 


gram itself intact. This statement is automatically executed 
when a RUN command is given. 


cmMD 
(linenumber] CMD filenumber [,printlist) 


Redirects output. For example, you should use the CMD 
statement when you want to send output normally directed to 
the screen to a file or the printer. Here “printlist” is a list of 
character strings, numeric variables, or expressions which is 
written to the device when the CMD statement is executed. 





NOTE: The CMD stotement must be used in conjunction with @ corresponding 
OPEN statement and both the OPEN statement and the CMD stotement must 
howe the same filenumber 








DATA 
[linenumber] DATA value [,value, ... value] 


Uses the DATA statement in conjunction with the READ 
statement(s) to enter numeric and string constants into a pro- 
gram 


DCLOSE 
{linenumber] DCLOSE [#If] [ON Uz] 
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COQCQCGCUCUUCLC( 


( 





Closes a single file or all the files currently open on a disk unit 
Here “I” represents the logical file number of the file to be closed on 
the disk and “2” is the number of the disk drive unit if more than 
one unit Js present. When using DCLOSE be aware that: 


1, DCLOSE (closes all files currently 
open on default device) 

2. DCLOSE #If (closes the file associated 
with the logical file number 
It) 

3. DCLOSE ON Uz (closes all files currently 


open on unit “2") 
DEF FN 
(inenumber] DEF FNna (argument)=formula 


DEF FN allows you to define a complex calculation as a 
single function with a short name. In the case of a long formula 
that is used many times in your program, this statement can 
save time and space. Here “na” represents any legal variable 
name, When appended to the letters FN, this becomes the func- 
tion name. The “(argument)” can be any numeric variable, and it 
must be enclosed in parentheses. 





NOTE: You must define your function with this DEF FR statement before you cen 
“call” it using the function name, 





DIM 
flinenumber} DIM variable(subscript! [,....subscriptn)), 
{variable(subscriptl,....subscriptn]), ..] 


Allocates storage for an array and specifies the maximum 
values for the array variable subscripts. Here “subscript” repre- 
sents the size of the DiMensions of the array you are creating. 





NOTE: You must use the DIM stotement te DiMension errays conteining mere 
than 10 elements, and “subscripts” must be enclosed in parentheses, In odd 
fion, yeu should be aware of the fact that the number of elements in one di- 
mension of en array equals the volve of the “subscript” plus 1 
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EXAMPLE: 10 DIM A8(40),  B7(15),  CC%(4.4.4) 








1 is 
41 elements 16 elements 125 elements 
DISPOSE 
{linenumber] DISPOSE <FOR | GOSUB> 
Used in error trap processing to eliminate unwanted NEXT or 

RETURN addresses from the stack. 

nd 
DOPEN ERI 


DOPEN #lf, “filename” 





-Ly] [Dd] [.ON Uz] [,W] 


Opens a data file for a read and/or write access. Here “If” 
represents the logical filenumber of the file to be opened, “y" is 
the record length for a nonsequential file, “a” is the disk drive 
number in which the disk containing the file is located, and “2 
is the drive unit number if more than one drive unit is present 
A sequential file is opened for write access if "W" iss present: 
it is opened for read access if “W" is}present. 








(inenumber] END 

Finishes a program that is running and returns control to the 
screen. 
FOR...TO...STEP 


(inenumber] FOR varia 
expression3] 








xpression1 TO expression2 (STEP 


Always associated with a@ NEXT statement, FOR... 
TO...STEP controls repetitive execution of a group of state: 
ments called a loop. Here “variable” is the counter for the loop. 
“expression1” represents the start value of the counter, “ex 
pression2” is the end value of the counter, and “expression3" is 
the increment value, added to the current value of the counter. 
When using FOR...TO...STEP be aware that: 

1) FOR variable=expression! TO expression2 (increments a 

STEP value of 1) 








GET 
linenumber GET variable 
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Scans the keyboard buffer and reads a single character from 
the buffer. If no character is typed. then a null (empty) character 
is assigned 











NOTE: GET is urvely followed by @ sting variable. If o numeric variable is 
used and @ NONnumeric key i pressed, your program will halt ond you will g 





fn error message. In addition, the GET statement may be placed in o loop to 
check for @ nll string (” 





result, This loop will continue until a key is pressed: 





GET# 


[linenumber] GET# filenumber, variable 





Reads a single character from logical file “filename”. 





NOTE: GET# con only be vied with previously OPENed device or file 





GosuB 
[linenumber] GOSUB linenumber2 





Always used with the RETURN statement, GOSUB is used to 
branch to the subroutine which starts with the BASIC state- 
ment labeled “linenumber2”. 








NOTE: GOSUB: without RETURNS will result in @ buildup of return address, 
ceventuclly covsing on out of stack en 








GOTO or GO TO 
[linenumber] GOTO linenumber2 


Unconditionally branches to the BASIC statement with the 
line number “linenumber2”. 


IF...GOTO 
[linenumber] IF expression GOTO linenumber2 


Evaluate the conditions in “expression” and, tf these conditions 
are met, branch to the statement located at “linenumber2". 
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IF...THEN...ELSE 





inenumber] If expression THEN then-clause [: ELSE els 
clause] Evaluates the conditions in “expression”. then, de- 
pending on the results, performs the action required in the 
“then-clause” or the “else-clause” 








NOTE: In most coses the “expression” will involve one or more of the following 
‘elotional operators 


= < <= = = <> AND OR NOT 





[linenumber] INPUT [promptstring :] variable list 


The INPUT statement allows the program to get information 
Jrom the person using the program by assigning that data to a 
variable. Most of the time, the informaticn needed by the pro- 

ram is in the form of a question. Therefore, after the INPUT 
“prompt string” is printed, the program stops and a question 
mark (?) is PRINTed to the screen, The computer then waits for 
the person using the program to type in a response and hit the 

<RETURN> key. Here the “promptstring” represents the 
Prompt, which is usually in the form of a question, and “vari- 
ablelist” is the list of variable names to associate with the data 
typed in 








INPUT# 
linenumber INPUT# filenumber, variablelist 


INPUT# is similar to the INPUT statement, except it takes 
data from a previously OPENed file or device. The “filenumber 
represents the number the file has been OPENed. The “vari- 
ablelist” represents the name(s) to associate with the input data. 


LET 
[inenumber] [LET] variable = expression 


The LET keyword is hardly ever used in BASIC programs be- 
cause it is an optional keyword. However, the fact that it is un- 
derstood places it at the heart of all BASIC programs. Here LET 
sets “variable” to the value defined by “expression”. 
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GOocct 


Cocaccac 


( 


if 


C 


NEXT 


[linenumber] NEXT [variable, . . ., variable] 





Always used in conjunction with a FOR statement, NEXT ts 
used to mark the end of a FOR... NEXT loop. When the pro: 
gram reaches a NEXT statement, it checks its corresponding 
FOR statement to see if the limit of the loop has been reached. If 
the limit has not been reached then the loop “variable” in the 
FOR statement is increased by the STEP value. If the loop 
finished then execution continues with the statement(s) in the 
line following the NEXT statement 














NOTE: NEXT may or may not be followed by "variable" nome. If no name: are 
listed, the lost loop started is finished. fone ” 





igble” name it given, it must 
correspond 10 an appropriotey positioned FOR stotement. If more thon one 
variable” follows a single NEXT, each loop is Finished, in order, from left to 
Fight end each “soriable” must have a corresponding FOR wi 
ble name, See FOR... TO... . STEP for more information, 





the some “vari 





ON...GOSUB 
[linenumber] ON expression GOSUB linenumber list 


ON... GOSUB is similar to an IF... THEN statement in that 
i evaluates the “expression” found after ON and then, based 
on the result, moves the program execution to the correspond- 
ing subroutine line number following the GOSUB. Here “ex- 
pression” represents the formula and “Iinenumber list” contains 
the list of the line numbers for each subroutine. The appropriate 


subroutine will be chosen depending upon the value of “expres- 
sion’: 














ON...GOTO 
[linenumber] ON expression GOTO linenumber list 


ON... GOTO ts similar to an IF... THEN statement in that 
t evaluates the “expression” found after ON and then, based 
on the result, moves the program execution to the correspond- 
ing line number following the GOTO. Here “expression” repre- 
sents the formula and “linenumber list” contains the list of the 
line numbers to GOTO. The appropriate statement will be cho 
sen depending upon the value of “expression”. 
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OPEN 


[nenumber] OPEN filenumber [,devicenumber {,command 
Lopenstring]]] 

The OPEN statement establishes an Input/Output (1/0) 
channel to the screen or an external device, such as a tape 
cassette, a disk drive, a printer, or to the IEEE serial bus. Here 
“filenumber” represents a number between 0 and 255 that is 
used to specify in statements like CLOSE, CMD, GET#, INPUT#, 
and PRINTS the specific file intended. Only statements with a 
corresponding “filenumber” will be able to access the file. The 
label “devicenumber” refers to the appropriate external device as 
mentioned above. You should be aware that 

1. OPEN 1,3 (OPENS the screen as a device) 
2, 10 OPEN 2.1,0."D"  (OPENs the Datassette™ for 
READing and then searches for 


file “D") 

3. 20 OPEN 3.4 (OPENs a channel to the printer) 

4. OPEN 4,815 (OPENs the command channel on. 
the disk) 





NOTE: As is indicated, the OPEN stotement may be executed in both direct ond 
rogrom modes. Linenumbers a 





ways necessary in program mode. For more 
information see the Programmer's Reference Guide for your computer or ony of 
the menuals that come with your external devices such as dis drive, 
Dotassete™ 








[linenumber] POKE location, value 

The POKE statement is always followed by two numbers or 
JSormulas. Here “location” represents a memory location from 0 
through 65535 and “value” is a decimal value from 0 through 
255 which is placed in “location” replacing any previously stored 
value. A previously executed BANK command selects the bank 
poked to. 


PRINT 


(inenumber] PRINT [printlist) 


PRINT writes the information specified in “printlist” to the 
screen. Here “printlist” can include any of the following: 
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1. Text whieh must always be enclosed in quotation marks 
en 

variable names 

Funetions 

4. Punctuation marks (used for formatting data) 














PRINT# 
[linenumber] PRINT# filenumber, printlist 


The PRINT# statement writes the values specified in 
“printlist” to the file associated with “filenumber’ 





NOTE: The “filenumber” used in the PRINT# storement must refer to the corre 
sponding file number vied with @ device or file thot has already been OPENed, 





PRINT USING or PRINT# USING 


[linenumber] PRINT [#filenumber,] USING formatlist : printlist 
G) 


Allows you to define a “formatlist” controlling the appear- 
ance of the suring and numeric output specified tn “printlist’. 
See the Programmer's Reference Guide for details. 


PUDEF 





[linenumber] PUDEF controlstring > defsvlt = 9 5 6 


Redefines four symbols which are printed with the PRINT 
USING statement’s formatting options. See the Programmer's 
Reference Guide for details. In this example, “controlstring” 
represents the format that you've designed for your data. 











READ 


[linenumber] RI 





EAD variable list 


READ processes one or more DATA statements and assigns 
the data tem values, on a one-to-one basis, to the variables in 
“variable list 





If the data in a DATA statement is not the same type as the 
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variable in the “variablelist", a syntax error which refers to the 
line number of the DATA statement results. 


RECORD 
(linenumber] RECORD# If, rno [.bno} 





Adjusts a relative file pointer to select any byte (character) of 
any record in the relative file. Consult the Programmer's Refer- 
ence Guide for more details. 


REM 
(linenumber} REM [text) 


A nonexecutable statement that is LISTed in your BASIC pro- 
gram. 


RESTORE 
Uinenumber} RESTORE [linenumber2] 


Resets the pointer for the current DATA statement to be pro- 
cessed by READ statements to linenumber2. 





RESUME 





[linenumber] RESUME [NE! 





T | linenumber2] 


Used in error handling to resume execution after an error is 
‘rapped and processed by your error handling routine. 


RETURN 
(linenumber] RETURN 


Completes subroutine processing and branches back to the 
statement following the GOSUB which started the subroutine. 


STOP 
[linenumber] STOP, 





Terminates program execution and returns to command 
level 


sys 
(linenumber] SYS jumpaddress 


Calls the assembly language subroutine at location “jump- 
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{ 


OQuacccdcc 


c 


address" (which is a decimal, not hexadecimal, address) and 
executes the machine language program starting at that ad- 
dress. 








NOTE: S75 will only jump into Segment 15 of the computer Random Access 
‘Memory (RAM) locations. This means that even if you were to select any other 
Bonk or momery segment the progrom will still ONLY jump into Segment 15. 








NOTE: Ail mochine language programs must end with an RTS (ReTura from Sub. 
routine) statement 





TRAP 
[linenumber] TRAP [linenumber2] 


Stops from functioning BASIC’s normal error handling and 
lets your program perform its own error handling. 


WAIT 





(linenumber] WAIT location,, mask] [.mask2] 


Continually tests the data at “location” and re-executes the 
WAIT statement or proceeds to the next executable statement, 
depending on the values of selected bits at location. 


BASIC FUNCTIONS 


ABS 





ABS (expression) 

The absolute value of “expresston’ 
ASC 
ASC (expression) 


The numeric value that repre 
character of “expression”. 


ATN 


ATN (expression) 


ents the ASCII code of the Jirst 





The aretangent of the “expression” in radians. 
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CHRS 
CHRS (expression) 


A string containing a single character whose value is the 
character with the ASCII code represented by “expression 


co! 








COS (expression) 

The cosine of “expression” in radians. 
ERR® 
ERR$ (expression) 


A character string which contains the text of the error mes- 
sage represented by “expression”. 


EXP 
EXP (expression) 


he value of e (approx. 2.71828183) raised to the power rep- 
sented by “expression”. 





FRE 
FRE (expression) 


The number of free bytes in a memory segment or bank indi- 
cated by “expression” 


INSTR 
INSTR (expression | .expression2[ ,expression3}) 


“Expression” is searched. beginning at the optional char 
acter position represented by “expression3”, for the occurrence 
Of the string represented by “expression2 





INT 
INT (expression) 


The largest integer which is le 
specified in “expression” 





than or equat to the value 
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( 


( 


LEFT® 
ion2) 





LEFTS (expression 1, expres 


The leftmost “expresston2” characters in the string repre- 
sented by “expression” 


LEN 
LEN (expression) 

The number of characters in “expression 
LoG 
LOG (expression) 

The natural logarithm of “expression: 
MID® 


MIDS (expression | .expression2[.expression3]} 








siring containing “expression3” characters of the string “ex- 
sion!”, beginning at the character position “expression? 





PEEK (expression) 


The byte read from memory location “expression” in the bank 
selected by a previously executed BANK instruction 


Pos 
POS (expression) 


The column where the next character will be written on the 
line currently containing the cursor. 





NOTE: Ail mochine longuage programs must end with am RTS (ReTurn from Subs 
routine) stotement 








NOTE: “expression” is necessary, but ignored. 
RIGHT® 


RIGHTS (expression 1, expression2) 





A string consisting of the rightmost “expression2” characters 


in the string “expression1”. 
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RND 
RIND (expression) 


Arandom number between 0 and 1. “Expression” is used as the 
seed value. See the Programmer's Reference Guide for details. 


SGN 





SGN (expression) 


A value indicating whether the value of “expression” is posi- 
tive (gives +1), negative (gives —1), or zero (gives 0). 


SIN 
SIN (expression) 
The sine of “expression” in radians. 
spc 
SPC (expression) 


Prints the number of blank spaces on the screen indicated by 
the number in “expression”. 


SQR 
SQR (expression) 

The square root of “expression”. 
STRS 
STRS (expression) 


A character 
value repres 


TAB 


TAB (expression) 





string containing a string representation of the 
nted by “expression” 





Positions the cursor in the column represented by “expres: 
sion”. 


TAN 
‘TAN (expression) 


The tangent of “expresston” in radians. 
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C 


USR 
USR (expression) 


Calls the use 
has 





written assembly language subroutine which 
starting address stored in locations 3 and 4 of bank 15. 
The argument (“expression”) is stored in the floating point ac 
cumulator prior to entering the subroutine, See the Program 
mer's Reference Guide for more details. 











VAL 
VAL (expression) 


The numeric value of the string “expression 


RESERVED SYSTEM VARIABLES 
AND Logical operator 

DS* Disk Status reserved word. 

EL Line number last error occurred. 

ER Error# of last error occurrence. 

OR Logical operator 

NOT Logical operator. 

STatus The system status for the last Input/Output operation. 


Time The character string representation of the current 
time-of-day registers. 


RESERVED SYSTEM SYMBOLS 


+ Plus sign: arithmetic addition or string 
concatenation 


= Minus sign arithmetic subtraction and 
unary minus 

* Asterisk arithmetic multiplication 

/ Slash: arithmetic division 
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(blank) Blank: 


Equal sign: 


© Less than: 
Greater than: 

1 Up arrow: 

. Comma: 
Period: 

; Semicolon: 


: Colon 


“ Quotation mark: 


? Question mark 


( Left parenthesis: 


) Right parenthesis: 


% Percent 


# Number: 


® Dollar sign: 
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separates keywords and 
variable names 


value assignment and 
relationship testing 


used in relationship testing 
used in relationship testing 
arithmetic exponentiation 


used in variable lists to format 
output also separates 
command parameters 


decimal point in floating 
point constants: 


used in variable lists to 
format output 


separates multiple BASIC 
statements on a program line 


eneloses string constants 


abbreviation for the 
Keyword PRINT 


expression evaluation and 
functions, 


expression evaluation and 
functions 


declares a variable name as 
an integer 


comes before the logical file 


number in input/output statements. 


declares a variable name as 
a string 


const 





the numeri 


nt 3141592654 


GCUOCUCOC. 


C 


( 
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BASIC 4.0 
ABBREVIATIONS 


KEYWORD 


ABS 
APPEND 





BACKUP 
BANK 
BLOAD 
BSAVE 
CHRS 
CATALOG 
CLOSE 

CLR 

CMD 
COLLECT 
CONCAT 
CONT 
COPY 

cos 

DATA 
DCLOSE 
DEF FN 
DELETE 
DIM 
DIRECTORY 
DISPOSE 
DLOAD 
DOPEN 


DCLEAR 





ABBREVIATION 





a 
b 
ba 
b 
b 
c 
- 
el 
= 
c 
co 
con ¢ 
c ro) 
co P 
none 
d A 
d fe 
d E 








TYPE 


function 


numeric 


statement 


function 
function 
commans 





umeric 
—numeric 


d 


statement 


commani 
commant 
function 
comman 


id 
id 

~string 
id 


statement 


statemer 


nt 


statement 


comman 
statemer 
comman 
comman 
function 
statemen 


id 
nt 
id 
id 

numeric 
at 


statement 


statemen 
comman 


nt 
id 


statement 


comman 


id 


statement 
command 


statemen 


command 


at 
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KEYWORD ABBREVIATION TYPE 








DSAV « Eo command 

END e statement 

ERR® function—string 
EXP s x function—numeric 
FOR f © statement 

FRE t R__ function—numerie 
GET g E statement 

GET# none statement 

GosuB go S statement 

GoTo g O statement 
HEADER h E command 
IF...GOTO none statement 

IF.. THEN..ELSE none statement 

INPUT none statement 


INPUT# i Eo statement 
. FT function—numeric 


none function—numeric 














le F  funetion—string 
none function—numeric 
1 E statement 
| EEG command 
i O command 
none function—numeric 
m I function—string 
none command 
n E statement 
ON...GOSUB none statement 
ON...GOTO none statement 
OPEN o EG Ps statement 
PEEK P E — function—numerie 
POKE P O statement 
POS none function—numeric 
PRINT 2 statement 
PRINT# p R__ statement 
PRINT USING ?us I statement 
PUDEF none statement 
READ r E statement 
RECORD re C statement 
REM none statement 
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KEYWORD ABBREVIATION 
RENAME, re N 
RESTORE re Ss 
RESUME J 
RETURN 

RIGHTS 

RND 

RUN 

SAVE 

SCRATCH 

SGN 

SIN 

spc 

SQR 

STATUS 

STOP 

STR 

sys 

TAB 

TAN none 
TIs none 
TRAP t R 
USR u Ss 
VAL none 
VERIFY u E 
walt w A 





TYPE 


command 
statement 
statement 
statement 
function —string 
function—numeric 
command 
command 
command 
function—numeric 
function —numeric 
function —special 
function —numeric 
function —numeric 
statement 
function —string 
statement 
function —special 
function—numeric 
function —string 
statement 
function —special 
function —numeric 
command 
statement 
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SCREEN DISPLAY 








CODES 

SET1 SET? POKE| SET! SeT2 POKE | SeT! SET? POKE 
@ 0 Uae Set | fe 42 
A a a v v 22 + 43 
B bo 2 Ww w 23 44 
G@ uc 63 aoe, Ser oy 45 
D d 4/ ¥ y 25 46 
EDS hss ee ae | 1 47 
F ' ea) <0 | o 48 
G 9 7 £ 2B 1 49 
Hy "he 48 1 20 | 2 50 
1 i 9 t 30 3 51 
J i 10 S 31 4 52 
K k 1 | (i 32 5 53 
L 1 12 ! 33 6 54 
M m 13 34 7 55 
N a 14 * 35 8 56 
O° ° 15 $ 36 9 57 
i Boe 1G) 96 37 58 
Q q 7 & 38 ; 59 
R i 18 4 39 < 60 
Ss s 19 ( 40 = 61 
Te Ste sage] 24 a | > 62 
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SET1 SET? POKE | SET! SET2 POKE | SET! SET2 POKE 

2 63 | ld U es | (H 107 
8 e| XI vos | 108 
@ a 6! QO wo e7|¥ 109 
(M 8 66] |} x |} §) 110 
B c ew{/M yy we] Q "1 
SG o «}]/@ z 9] mq 112 
A c« of] a} a 113 
O -r 7] & 92 | fA 114 
e a|@ 93 | A) 115 

[ 4h 72/7 & «lO 116 
Jot al NW S os] 0 117 
NS . 7 |B ss | 118 
PF) k sli 7/0 119 
O t vw] wg os | 120 
N oo 7 99 | (ad 121 
A n vw} 10} CL) M122 
mo!) se 11] Gl 123 
O pep «el & 102 | (3 124 
@ aia 103 | B) 125 
Oo rks 82] bea 104 | #) 126 
vy) s a] W 105 | Me 127 

cer ee | 106 


Codes from 128-255 are reversed images of codes 0-127. 
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CHR & CODES 
[errs cHms | PR's cHRs | PRINTS cHrs | PRINTS HRS 
: 0 23 4] & 69 
1 24 1 a7] oF 70 
Fl 2 25 o «| 6 nm 
stop} 3 26 1 49 H 72 
Tee] 4 27 ee SOF] ) i 73 
Ea 5| 2 3 51 J 74 
>| 8 29 4 52 K 75 
7)/M ~/ 5 wl i 
poosGGs MA 31 6 54) 0M 7 
(FEE) poo 7 s5| N 78 
8 | 0 79 
9  s7/ Peo 
s8| Qa 
> 59] RB 
< eo] s a3 
= 68 | at c8e 
> 62 u 85 
? 63 v 86 
@ all 87 
A 65] x 88 
B66} y a9 
ce} z 9 
| 22 4] 0 68} | 91 
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PRINTS CHAS | PRINTS CHAS | PRINTS CHRS | PRINTS CHE 
£ 92 | id 117 UO ste7 
1 9 |X 16 fe 168 
t «|/O  i9 WH) t69 
- |) 120 | G15) Oo 0 | 
So) Dia | asus | (Hon 
(s) 97 | tz | 47 | Lele 
D oo | A oz | Ge | (S173 
SB o/M ww] (y wl f 17 
GH w}/M ws) mK wo} Oo wzs 
6 101 | fr 16] O 151 | (A 176 
Q 102 | yz | (&) ose | A oaz7 
I 103 128 ] 183) 17% 
(1108 | fa} 20 | Ht | A 79 
iN 105 190 | FA otss | LE) 180 
TS tos | (ows 131 | gm ose | te 
| 2] 107 re | GB os7) OD tee 
: Ot | 133 | @m oe | Te 
- N 109 | 3 194. | MA iss | PS tes 
Z wl s 135 | GMB 160 | Oy tes 
O wile ww) 0] Oi 
o 12 | 12 137 | fg 162 187 
oe 113 | 14 138 | 1 103 188 
oO 14) {6 139 | [164 189 
- v 115 | 8 wo} C165 190 
{ 116 | SONOS 41 | ts 191 
CODES 192-223 SAME AS 96-127 
CODES 224-254 ‘SAME AS 160-190 
CODE 255 ‘SAME AS 126 
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SCREEN MEMORY 
MAP (B Series) 
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APPENDIX F 


SCREEN AND COLOR 
MEMORY MAP 
(C128-40) 


Screen Memory Map 
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or 


COQCCCUOCLCE 


CC 


C 


C 


Color Memory Map 
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APPENDIX G 


MATHEMATICAL 
FUNCTIONS TABLE 


FUNCTION 
secant 
cosecant 
cotangent 
inverse sine 
inverse cosine 


inverse secant 
inverse cosecant 


inverse cotangent 
hyperbolic sine 
hyperbolic cosine 
hyperbolic tangent 


hyperbolic secant 
hyperbolic cosecant 
hyperbolic cotangent 


inverse hyperbolic sine 
inverse 
inverse 






cosine 
tangent 
inverse 


inverse hyperbolic cosecant 


inverse hyperbolic cotangent 
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BASIC EQUIVALENT 
sec(x)=1/e08(x) 
ese(x}= 1/sin(x) 
cot(x}= 1/tan(x) 


arcsin(x}=atn(x/sqr( —x*x+1)) 





arceos(x)=~atnix/sqr(-x"x+1)) 
+7/2 

arcsec(x)=atn(x/sqr(x*x~1)) 
arcese(x)=atn(x/sqr(x*x~ 1) 








+(sgnx)—1 "7/2 
arcot(x)=atn(x)+"/2 
sinh(x)=(exp(x) ~exp(—x)/2 
cosh(x)=(exptx} + expt —x))/2 
tanh(x)=expl—x)/ 
(expix)-+exp(—x))*2+1 
sech(x)=2/lexp(x) +exp(—x)) 
esch(x)=2/lexp()-exp(—x)) 
coth(x)=expl—x)/ 
(exp(x)-exp(—x))"2+1 
arcsinh(x)=log(x-+sqrtx"x+ 1) 











arceosh(x)=log(x-+sqrtx*x— 1)) 
arctanh{x)=log((1+x)/(1—x))/2 
aresech(x)=logl(sqr{—x"x-+1) 
+1/x) 
arcesch(x)=log((sgn(x)* 
sqrix*x=1/x) 


arceoth(x) =log((x+ 1)/(x~1))/2 


( 


C 


( 
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PINOUTS FOR 
INPUT/OUTPUT 
DEVICES 


Your computer is equipped with several specialized chips 
BANK 15. The 6526 Complex Interface Adapter is located at 
56320 (SDC0O), The 6551 Asynchronous Communication Inter- 
face Adapter is located at 56576 ($DDO0), Your computer has 
two 6525 Tri-port Interface chips located at 56832 ($DE00) and 
57088 (SDFOO). For more information, consult your Program 
mer's Reference Guide. 


win 














Commodore 128 


System Bus Connectors 











‘ExTBUFCS r 














2 ToOCLK s 
22 | OTSKROMCS 2 
a ‘BoOTCLK. % ; 
s se & { 
FS cos Py 
8 cst 8 
* EXTPRTCS ‘0 
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IEEE Connector 
































ao tm [twe | em | te 
ab j 0: * % 
1 de H oe ° oe 
ak 3 & é or 
Ak ‘ oe 5 | be 
aon 5 ec : men 
ie ‘ wy : on 
Has ‘ noe |S ore 
a ” 10 SRO t GND 
* . " ATN u GND 
Ee 
RS232—C Connector 
oe 
ale ole i ‘SHIELD “ NC 
alo OF 7 OND 2 DIR 
arfo oe 8 pcp a NG 
alo of, ° " a we 
zie ole * on 
Connector 
fe a & | eer 
. Be c soz 
‘a ABS D 8083 
i ABA e B0Be 
" fos ' fos 
y fi m | see 
x fer : Pty 
: on «| Ge 
Is so ‘ eo 
“ mew | | Sew 
fon | ow ce 
" woz | | coma 
4 we | om | capanne 
wy TS | esta 
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COQQCCCUCCC( 
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( 

















5 5 
1 19 
ni 21 
8 2 
alo clio 
as|o o|25, 








User Connector 






































5 8 08 
Cassette Connector 

Pin Type Pin Type 

vA ‘cno -AS READ 

20 5 CAS WRITE 
Co—Processor Dram Bus 
Connector 

3 EXPMAD? 23 ‘GND 

4 ORAMDY | ponerREO 

; xeMRO? 2 ‘GNo 

6 RAMO? 6 | peneronr 

r EXPMADS a GN 

> ORAM % are 

9 EXPMADY ” SPARE 

6 DRAM Busy? 

8 ‘ono ws eas 
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AudiolVideo 
Connector 


5—Pin Din 





in 


we 





+12 





(Koy « SLT) 
NO 


Audio Out 
Comp, Video 











Tye 











3 Game? 


GAME 0 
GAME 


GAME 3 
Teigget 
v 

GNO 

Pot 








Commodore 128 








System Power Supplies 
ownage | cunent 
vey SSA 
ev oan 
Trav O38 
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Game Port 1 





Pin Tye 





‘ame 0 
Game 1 
Game 2 
Game 3 

Pot¥ 
TWiggertight Pen) 
“sv 
Gxo 
Pot x 














Game Ports are 9 Pin 
D-Subminiatore Male Plug 
Connectors 


System Power Consumption 




















tem voitage | Curent (an) 
Main PG boars | a5v aA 
fav 0.150, 
Rv 0.050 8 
CoProvessor +s¥ oBA 
Low Cost Disk ssw 02054 
cantiee osv 05008 
(0050 & 
Rsz26 ov 0078.4 
0.0504 
cass s5v 0150.8 
sv 
Notes 


1. Maximum Power Output of Power Supply 
| 32 Walls. Therefore Maximum 
Curren for al outputs ean not Re provides 





2. Maximum System with al features 
Grawing Maximum Power will exceed 
ower rating of Sup 





_ B Series 


TRIDOE 
RTP IDOE 





Exiy%)0n Connector Pin—Outs 



















































































ts H 
in e 
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5 P mt x 
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Es | een el Mesa eet onde yet ee 
Keyboard Connector RS 232C Connector 
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S00 
fee 
Toa NS 
IEEE Connector 
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oe °| 
to fe] ew 
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n 
a 
a 
Zz 
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Cassette Connector 











Pin Type 
ve GND 

28 *5 VG (CASSETTE ONLY} 
36 casMTA 

40 CASREAD 

Se case 

6F cassw 














c 

€ 
Jo ole 
slo ole 
19]0 0] 20 
aio ole 
alo ola 
zs[o ola 
aifo ofa 
alo of 
alo ola 








Co-Processor Connector 














Type Pin Tw. 
5 exTuag 2 DRAWOO 

2 exTuaz a RAMON 

5 exiwa? 6 DANO? 

> Exruas a DraMoS 

* bermas 10 DRAMOe 

" pxTMad 2 RAMOS 

3 extwat rf ORAMOE. 

8 extmao 6 DRAMO? 

7 no we | oxo 

a no 7% | GN 

2 no 2 NoT Busy 

2 ono 2 NOT PaREFREO 
25 No 2% NOT PaREFGRNT 
2 no os 2P0 

2 no 0 2p! 

ey ono x Pe 

u Nc a 83 

% Notprocaes | 36 Nor Busre 

” exrauraw % NOT ERAS 

6 ORAM As 7 NOT ECAS 
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( 


( 





Expansion Connector 









































NOT extauFes, 
NOT OISKRONES 
NOT cas. 

ner esi 




















Audio Jack Video Connector 
Pin Pin Type 











Power Connector 



































Pin Type 
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APPENDICES 


APPENDIX I 


CONVERTING FROM 
STANDARD BASIC TO 
EXTENDED BASIC 4.0 


If you have programs written in a BASIC other than Commo- 
dore BASIC, some minor adjustments may be necessary before 
running them with Commodore BASIC. Here are some specific 
things to look for when converting BASIC programs. 








String Dimensions 


Delete all statements that are used to declare the length of 
strings. A statement such as DIM A8(I.J). which dimensions a 
string array for J elements of length I, should be converted to the 
Commodore BASIC statement DIM A%J). 

Some BASICs use a comma or ampersand for string concate- 
nation, Each of these must be changed to a plus sign, which is 
the operator for Commodore BASIC string concatenation. 

In Commodore BASIC, the MIDS, RIGHTS, and LEFTS func- 
lions are used to (ake substrings of strings. Forms such as AS(I) 
to access the “Ith” character in A8, or A&{I.J) to take a substring 
of AS from position I to position J, must be changed as follows 


Other BASIC Commodore BASIC 





AS(D=XS. AS=LEFTS(AS, 1-1) +X$-+MIDS(A$, 16021) 
AS(U,J)=XS. AS—LEFTS(AS,1— 1) +X$-+MIDS(AS,J+1) 


Multiple Assignments 


Some BASICs allow statements of the form: 


10 LET B 





0 
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to set B and C equal to zero. Commodore BASIC would interpret 
al operator and set B equal to ~1 


convert this statement to two assign: 





the second equal sign as a logit 


if C equaled 0. Instea 





ment statements: 
10 ¢=0:8=0 

Multiple Statements 

Some BASICs use a backslash to separate multiple statements 


on u line. With Commodore BASIC, be sure all statements on a 
line are separated by a colon 





MAT Functions 


Programs using the MAT functions available in some BASICs 
must be rewritten using FOR... NEXT loops to execute properly 


Differences From Older Commodore BASIC 


Tl references must be changed. The current smallest unit of t 
is 1/10 sec. rather than 1/60 sec. Therefore, VAL (TI8)*6 
previous version’s TI value. 





me 
equals 





ER is now a reserved variable. All references must be changed to 
use a new variable name. ER returns the error number (127 is 
no error) 


EL is now a reserved variable, All references must be changed to 
use a new variable name. EL 
error (65535 





eturns the line number of the last 





is no error) 
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ERROR MESSAGES 


# MESSAGE 
0. stop key detected 


1. 200 many files, 





?file open 


3. file not open 
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EXPLANATION 
Occurs when doing a KERNAL 
1/0 function and the STOP key 
is pressed. May occur during 
LOAD or SAVE (or OPEN. 
CLOSE, GET#. INPUT#, 
PRINT# when the cassette tape 
ls moving). Cassette tape files 
should be CLOSEd to save 
previously written information 
Disk files are not damaged. 








You are trying to OPEN more 
than 10 files at a time. Decrease 
the number of OPEN or DOPEN 
files by CLOSING them. 


An attempt was made to 
redefine file parameter 
information by repeating an 
OPEN command on the same 
file twice. 


The operating system must have 
device number and command 
information provided by the 
OPEN statement. If an attempt 
is made to read or write a file 
without having done this 
previously, then this message 
appears. 


( 


( 





10. 


MESSAGE 
‘file not found 


device not present 


not input file 


not output file 


?missing filename 


illegal device number 


are you sure ? 


EXPLANATION 
The named file specified in 
OPEN or LOAD was not found 
on the device specified. In the 
case of tape I/O, an end of tape 
mark was encountered. 


No device on the IEEE was 
present to handshake an 
attention sequence. May happen 
on OPEN, CLOSE, CMD, 
INPUT#, GET#, PRINT#. If 
filename is not specified with 
OPEN, this error will not occur. 





Tape files. once opened for 
writing, cannot be read without 
first CLOSEing, rewinding tape, 
and OPENing for INPUT. This 
message appears when an 
attempt is made to read an 
output file 





Tape files cannot be read and 
updated in place. Device is the 
keyboard and it cannot be 
written to. 


LOADs and SAVEs from the 
IEEE port (e.g., the disk) 
require a filename to be 
specified, Supply the filename. 


Occurs if you try to access a 
device in an illegal manner. For 
example, LOADing or SAVEing 
on the keyboard. screen, or 
RS-232 





This is a prompt for BACKUP, 
SCRATCH, and HEADER, It is 
not an error message and 
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# MESSAGE 


11. bad disk 


14. break 


15. extra ignored 


16. redo from start 


20. 





next without for 


21. syntax error 
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EXPLANATION 
should not occur during BASIC 
program execution. 


Media failure on HEADER 
command. 


This occurs when the STOP key 
is pressed during normal BASIC 
execution. The CONTinue 
command can be used to restart 
the program. 


Too many items of data or 
separators (,) were typed in 
response (o an INPUT 
statement. Only the first few 
items were accepted. 


Is not actually a fatal error 
printed in the standard format 
but is a diagnostic which is 
printed when data in response 
to INPUT is non-numeric where 
a numerie quantity is required. 
‘The INPUT continues to 
function until acceptable data 
has been received. 


Either a NEXT is improperly 
nested or the variable in a NEXT 
statement corresponds to no 
previously executed FOR 
statement 


BASIC cannot recognize the 
statement you have typed. 
used by such things as 
missing parentheses. illegal 
characters, incorrect 
punctuation, misspelled 
keyword. 





( 


CCOGCUCULCCC( 


i 


Ct 


# 
22. 


23, 


24. 


MESSAGE, 
?return without gosub 


Pout of data 


illegal quantity 


EXPLANATION 
A RETURN statement was 
encountered without a previous 
GOSUB statement being 
executed. 








A READ statement was executed 
but all of the data statements in 
the program have been read. 
‘The program tried to read too 
much data, or insufficient data 
was included in the program, 
Carriage returning through a 
line READY on the Commodore 
128 or B Series video display 
sometimes yields this error 
because the message is 
interpreted as READ Y. 


Occurs when a function is 
accessed with a parameter out 
of range caused by: 

1. A matrix subscript out of 
range (0 < X < 32767) 

2. LOG (negative or zero 
argument) 

3. SQR (negative argument) 

4, ATB where A<0 and B not 
integer. 

5. Call of USR before machine 
language subroutine has 
been patched in 

6. Use of string functions 
MIDS, LEFTS, RIGHTS, with 
length parameters out of 











range (1 < X < 255) 
7. Index on... GOTO out of 
range. 


8. Addresses specified for 
PEEK, POKE, WAIT. and SYS 
out of range (1 <X < 255) 
Byte parameters of WAIT 





© 
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# 


25, 


26. 





MESSAGE 


overflow 


2out of memory 


PENDIX 


EXPLANATION 
POKE, TAB and SPC out of 
range (0 < X < 255). 


Numbers resulting from 
computations or input that are 
larger than binary 

1.70141 184E +38 cannot be 
represented in BASIC’s number 
format. Underflow is not a 
detectable error but numbers 
less than binary 
2.93873587E -39 are 
indistinguishable from zero. 


May appear while entering or 
editing a program as the text 
completely fills memory. At run 
time, assignment and creation 
of variables may also fill all 
variable memory. Array available 
declarations consume large 
areas of memory even though a 
Program may be rather short. 
The maximum number of FOR 
loops and simultaneous 
GOSUBs are dependent on each 
other. This context is stored on 
the microprocessor hardware 
stack whose capacity may be 
exceeded. To determine the type 
of memory error, examine the 
results of FRE. If there is a large 
number of bytes available, it is 
most likely a FOR-NEXT or 
GOSUB problem. A subroutine 
which terminates in GOTO 
rather than RETURN will 
eventually cause an out of 
memory error as stack pointers 
build up. 


# 
27. 


28. 


29. 


30. 


31. 


MESSAGE 
?undefined statement 


?bad subscript 


?redim’d array 


?division by zero 


Pillegal direct 


EXPLANATION 

An attempt was made to GOTO, 
GOSUB, or THEN toa statement 
which does not exist. 


An attempt was made to 
reference a matrix element 
which is outside the dimensions 
of the matrix. This may happen 
by specifying the wrong number 
of dimensions or a subscript 
larger than specified in the 
original dimension 





After an array was dimensioned. 
another dimension statement 
for the same array was 
encountered. For example 
array variable is defined by 
default when it is first used, and 
later a DIM statement is 
encountered. 


an 








ero as a divisor would result in 
numerie overflow—thus it is not 
allowed. When this message 
appears, it is most expedient to 
list the statement and look for 
division operators. 


A single 80 column buffer area 
used by BASIC to process 
incoming characters. This same 
buffer is used to hold a 
statement that is being 
interpreted in direct mode. 
INPUT will not work because 
incoming characters would 
overwrite the variable list 
following INPUT to be processed, 
DEF cannot be used in direct 
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# 


32. 


33. 


34. 


35. 


37. 


104 


MESSAGE 


type mismatch 





string too long 


file data 


‘?formula too complex 


‘?undefined function 


APPENDIX 


EXPLANATION 
mode for a different but similar 
reason. The name of a function 
is stored in the BASIC variable 
area with pointers to the string 
of characters which define the 
function. Since the function 
exists only in the input buffer. it 
is wiped out the first time a NEW 
command IS typed in. 


‘The left-hand side of an 
assignment statement was a 
numeric variable and the 
right-hand side was a string, or 
vice versa; or a function which 
expected a string argument was 
given a numeric one. or vice 
versa. 


Attempt by use of the 
concatenation operator to create 
a string more than 255 
characters long. 





Oceurs when an INPUT# 
statement finds a string while 
attempting to read a numeric 
value. 


This indicates that BASIC has 
run out of string temporary 
pointers to keep track of 
substrings in evaluating a 
string expression. Break the 
string expression into two 
smaller parts to cure the 
problem. 


Reference was made to a user 


( 


( 


C 


# 


38. 


39. 


40. 


41, 


42. 


43, 


MESSAGE 


‘load error 


everily error 


Pout of stack 


?unable to resume 


2unable to dispose 


Pout of text 


EXPLANATION 


defined function which had 
never been defined 


Only occurs when loading a 
program from cassette tape. 
‘This means that there were 
more than 31 errors in the first 
tape block or that there were 
errors in exactly the same 
corresponding positions of both 
blocks. 


The contents of memory and a 
specified file do not compare. 





Too many levels of FOR 
NEXT or GOSUBs have been 
executed. No recovery possible 


A fatal error has oceurred, such 
as running out of stack. 


All of the DISPOSE type items 
have been disposed of or none 
exist 


If any LOAD or DLOAD exceeds 
the end of the text bank of (64K) 
this error will result. This error 
will not occur when using the 
BLOAD command. 
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NONERROR 
MESSAGES 


The messages listed below are available through the ERROR 
MESSAGE code numbers by using the ERRS calling codes listed 
next (o each message. However, these messages are not Error 
Messages so they will not appear on the sereen unless you spe- 
cifically call for them in your programming or call for them as a 


standard operating proced 


MESSAGE 


12. 


13. 


17. 


18, 


19. 


106 


(carriage return) ready 


(carriage return) 


(space) in (space) 


your last 
number 





more (carriage return) 


power on message 





EXPLANATION 
This message lets you know that 
your system is ready to use. 


This message is similar to 
ready 


This is the last number that has 
been evaluated through the 
numerical output buffer. (e.g.. 
print 10°10: if you use an ERS 
code 17, the number on your 
screen will equal the last 
evaluation —in this case, 100.) 


***COMMODORE BASIC 128, B4.0*** 


***COMMODORE BASIC 256, B4.0*** 
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6581 (SID) CHIP 
NOTE VALUE 


TABLE 
(C128-40 ONLY) 


MUSICAL OSCILLATOR MUSICAL 





NOTE FREQUENCY 
DECIMAL HI LO 

0 co 268 1 12 

1 C#0 2840128 

2 DO 301145 

3 D#0 318 1 «62 

4 £0 337181 

5FO  ) 358 1 102 

6F¥0 | 379° 1 123 

7 GO 4011 145 

8 G#O 425° 1 169 

9 A0 4511 

10 A#O 4771 

11 BO 5061 

16 CL 53602 

17 C#1 5682 

18 DI 602 2 

19 DAL a7 

20 EL 6752 

21 Fl 7160 «2 

22 F#I 758 2 

23 GI 803 3 

24 G#1 851 3 

25 Al 902 3 

26 A#1 955 3 

27 BL 10123 





NOTE 


32 
33 
34 
35 
36 
37 
38 
39 
40 
al 
42 


50 
5 

52 
53 
54 
55 
56 
57 
58 
59 


c2 
c#2 
b2 
b#2 
E2 
F2 
F#2 
G2 
GH 
AQ 
A#2 





D3. 
D#3 
E3 
3 
F#3 
G3 
Ges 
a3 
AH 
B3 


OSCILLATOR 
FREQUENCY 


DECIMAL HI LO 


1072 
1136 
1204 
1275 
1351 
1432 
1517 
1607 
1703 
1804 
1911 

2025 
2145 
2273 
2408 
2551 
2703 
2864 
3034 
3215, 
3408 
3608 
3823 
4050 
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MUSICAL OSCILLATOR 
NOTE FREQUENCY 


DECIMAL HI LO 


64C4 
65 C#4 
66 D4 
67 D#4 
68 E4 
69 F4 
70F #4 
71G4 
72G#4 
73A4 
74 A#4 
75 Ba 
80C5 
81C#5 
82D5 
83 D#S 
B4 ES 
85 F5 
86 F #5, 
87G5 
88G#5 
89A5 
90 A#5 
91BS 
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4291 
4547 
4817 
5103 
5407 
5728 
6069 
6430 
6812 
7217 
7647 
8101 
8583 
9094 
9634 
10207 
10814 
11457 
12139 
12860 
13625 
14435 
15294 
16203 


16 
17 
18 
19 
21 
22 
23 
25 
26 
28 
29 
31 
33 
35 
37 
39 
42 
44 
a7 
50 
53 
56 
59 
63 


195 
195 
209 
239 
31 
96 
181 
30 
156 
49 
223 
165 
135 
134 
162 
223 
62 
193 
107 
60 
57 
99 
190 
75 


MUSICAL OSCILLATOR 
FREQUENCY 


NOTE 


96 C6 
97 C#6 
98 D6 
99 D#6 
100 E6 
101 F6 
102 F#6 
103 G6 
104 G#6 
105 AG 
106 A¥6 
107 BE 
11207 
113 C#7 
114D7 
115 D#7 
116 E7 
117 F7 
118 F#7 
119G7 
120 G#7 
121 A7 
122 A#7 
123 B7 


17167 
18188 
19269 
20415 
21629 
22915 
24278 
25721 
27251 
28871 
30588 
32407 
34334 
36376 
38539 
40830 
43258 
45830 
48556 
51443 
54502 
57743 
61176 
64814 


67 
7 
75 
79 
84 
89 
94 
100 
106 
112 
119 
126 
134 
142 
150 
159 
168 
179 
189 
200 
212 
225, 
238 
253, 


DECIMAL HI LO 


15 
12 
69 
191 
125 
131 
214 
121 
115, 
199 
124 
151 
30 
24 
139 
126 
250 
6 
172 
243 
230 
143 
248 
46 
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6581 (SID) CHIP 
REGISTER MAP 


‘The 6581 Sound Interface Device ts located starting at location 
55808 ($DAO0O). Below is a brief register map. For detailed in 
formation, consult the Programmer's Reference Guide- 
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B SERIES 
MEMORY MAP 


2 Series Memory Mop 1B Series Memory Map 
Segmant OF UO Adsrese lock 
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C128-40 
MEMORY MAP 


seco sec seer 
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oc 


CCCECacoccoaooococoecoodd 


€ 


€ 


ecc 
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OPENING THE 
RS-232 CHANNEL 


‘The OPEN statement for an RS-232 channel has some special 
arguments that you must understand before you can use it. You 
must match the operating parameters of the RS-232 interface to 
those of the device you're connecting to the(P-500/B-700. 

When you open an RS-232 channel, your OPEN statement 
must look like this: 


OPEN filenumber,2,secondary-address, openstring 
Where: 
Jfilenumber is the logical file number to be associated with 
the RS-232 channel. 
secondary-address determines the direction of the RS-232 
channel. It can be input, output, or bidirectional and may or 


may not convert between CBM and ASCII character codes. 


openstring is a four-byte command stringthat establishes 
the operating parameters for the RS-232 channel. 


The secondary-address may take any of the values shown in 
Table 8.1 
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TABLE 8.1 RS-232 DIRECTIONAL SECONDARY ADDRESSES 





VALUE MEANING 

1 open an output channel 

2 open an input channel 

3 open an input/output channel 
9 


12 open an output channel and convert 
CBM to ASCII character codes 

130 open an input channel and convert 
ASCII to CBM character codes 

131 open an input/output channel and 


convert between CBM and ASCII 
character codes 





hy 
‘The secondary-address values 1, 2. and 3 do not perform and 
character conversions. If you're getting ASCII character codes 
through the RS-232 channel, they are delivered as-is to your 
program. If you want CBM/ASCII conversion you must select a 
secondary-address value of 129, 130, Or 131. 





‘The openstring for the RS-232 interface is four bytes long. The 
first two bytes contain detailed control information. The last two 
aren't used, but you must include them. 
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88 0) 
BAUD RATE 
of o]o]o] 16 ExteRNAL 
STOP BITS ofolo]s| soeaup i 
(ol ‘i 
ieee cD a 
6 BIT PARITY ofols]a] 10 3 
1-1.5 STOP BITS 
5 BIT NO PARITY oft folo] 1345 u 
1-2 STOP BITS. 
ALL OTHER o|1fol1] 150 5 
BAGES o}1]1}0] 300 t 
WORD LENGTH ol talanlin eee 
BT] DATA é 
6 | 5| WORD LENGTH 1{0]o} 0] 1200 4 
o a aiTs 1[0]o] 1 | (1800) ) 
oft] zens 1[o]1]o] 2400 2 
to] eaits aol] +} s600 7 
: [1] seins 1[{1 [0] 0] 4800 2 
1[1[o] 1 7200 IF 
RECEIVE CLOCK 
1[1[1] 0] 9600 ye 
0 = EXTERNAL 
1 = INTERNAL 1 [4 [1] [19200 15 























First Byte Open String 
RS.232 
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Felts) 


PARITY OPTIONS. 

(sit]eiT[srr 

71615 OPERATIONS 

o [PARITY DISABLED, NONE 
GENERATED/RECEIVED 














0} 0 | 1 [O00 Parity 
RECEIVERITRANSMITTER 
of 1 | a [EVEN PARITY 


RECEIVERITRANSMITTER 


1] 0 | 4 [MARK TRANSMITTED 
PARITY CHECK DISABLED. 


+] 4 | [SPACE TRANSMITTED 


























PARITY CHECK DISABLED 





ECHO 
psecex a 
3 [NORMAL ]eULL 


ECHO ACE 


a 





UNUSED 
UNUSED 
UNUSED 


UNUSED 
Second Byte Open String 
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